home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / disk / xdcpy200.zip / XDSKCPY.DOC < prev    next >
Text File  |  1993-09-15  |  5KB  |  149 lines
  1.  
  2.  
  3.  
  4.        XDSKCPY.EXE     (eXtended DiSKCoPY)                [v1.0: 27/6/1992]
  5.        ===========     ===================
  6.  
  7.  
  8.  
  9.        Copies entire diskettes in one drive, eventually using Extended
  10.        Memory (XMS) and harddisk space for buffering to avoid diskswapping.
  11.  
  12.        This program is FreeWare: It might be distributed and used freely.
  13.        There exists no warranty, and the author shall not be liable for any
  14.        loss or damage due to using this program.
  15.  
  16.        Written in C/assembly using Borland's nice compilers by
  17.  
  18.            Sverre H. Huseby
  19.            Bjoelsengt. 17
  20.            N-0468 Oslo
  21.            Norway
  22.  
  23.            Phone: +47 22 23 05 39
  24.  
  25.            Internet: sverrehu@ifi.uio.no
  26.  
  27.        I you like the program, please do me a small favour: Mail me and
  28.        tell me about it. That's worth more than a few bucks!
  29.  
  30.  
  31.  
  32.        Introduction
  33.        ------------
  34.  
  35.        The DOS-program DISKCOPY can only use `conventional' memory, that is
  36.        memory below the infamous 640 kb barrier. This results in tedious
  37.        diskswapping when copying diskettes other than 360 kb in one drive.
  38.        It also results in having to read the source diskette once for each
  39.        copy when making several duplicates of one disk.
  40.  
  41.        XDSKCPY fixes this by reading in the _entire_ source diskette before
  42.        writing it to one or more destination disks. If Extended Memory is
  43.        available (through XMS), the program enters as much as will fit
  44.        here, and eventually stores the rest in a temporary file.
  45.  
  46.  
  47.  
  48.        Usage
  49.        -----
  50.  
  51.        Options to XDSKCPY start with a '-' or a '/'. Note that the options
  52.        are case sensitive. The command line syntax is:
  53.  
  54.            XDSKCPY [options] drive
  55.  
  56.        Options can be zero or more of the following:
  57.  
  58.            -b  Beep when it is time to insert a new diskette, and when the
  59.                copying is finished.
  60.  
  61.            -f  Format the destination diskettes. XDSKCPY will also format
  62.                diskettes when it can't get information about the type,
  63.                assuming the diskette is unformatted.
  64.  
  65.            -n  Number of copies. This should be immediately followed by a
  66.                number, eg: -n2 for two copies. Default is 1 copy.
  67.  
  68.            -p  Prompt for another diskette to copy when finished. This is
  69.                on by default.
  70.  
  71.            -t  Specify directory for the temporary file. This is only used
  72.                if there is not enough memory to hold the entire diskette
  73.                contents. The directory name should immediately follow the
  74.                t, as in -tc:\tmp.
  75.                If no temporary directory is given, the program looks for
  76.                environment variables TEMP and TMP (in that order). If none
  77.                of these exists, the temporary file is opened in C:\
  78.  
  79.            -v  Verify the diskette. As default, verifying is done if DOS'
  80.                VERIFY is on. Enter -v- to override this to off.
  81.  
  82.        Starting the program with no arguments will bring up a short help.
  83.        Note that this program accepts one drive parameter only.
  84.  
  85.  
  86.  
  87.        The environment variable XDSKCPYCMD
  88.        -----------------------------------
  89.  
  90.        Before the command line options are interpreted, XDSKCPY looks for
  91.        an environment variable named XDSKCPYCMD. This might contain
  92.        frequently used options. If you for instance always want the beep,
  93.        and never want to be asked for a new diskette, enter the following
  94.        line in your AUTOEXEC.BAT:
  95.  
  96.            SET XDSKCPYCMD=-b -p-
  97.  
  98.        Any sequence of legal options may be given, and they can all be
  99.        overridden on the command line.
  100.  
  101.  
  102.  
  103.        Handling errors
  104.        ---------------
  105.  
  106.        If an error occurs during read, format, write or verify, the program
  107.        will ask you what action to take.
  108.  
  109.        When reading the source diskette, the action can be one of the
  110.        following:
  111.  
  112.            Abort           Exit the program.
  113.  
  114.            Reread          Try to reread the track where the error occured.
  115.  
  116.            Skip            Skip the bad track, and write a zero-filled
  117.                            track to the destination diskette.
  118.  
  119.        When an error occurs on the destination diskette, the following
  120.        options are given:
  121.  
  122.            Abort           Exit the program.
  123.  
  124.            Rewrite track   Try to write the track once more.
  125.  
  126.            rewrite Disk    Copy to another diskette. This will ask you to
  127.                            insert a new diskette.
  128.  
  129.            Skip            Skip the bad track.
  130.  
  131.        Choose your action by pressing the capitalized letter. Note that
  132.        both Skip-options will give you a copy that does not fully match the
  133.        original.
  134.  
  135.  
  136.  
  137.        Finally
  138.        -------
  139.  
  140.        If you decide to use this program, thanks! I would be happy hearing
  141.        from you if you find any bugs, have any suggestions, or just to know
  142.        that one more person uses my program.
  143.  
  144.  
  145.  
  146.                                                    Sverre.
  147.  
  148.  
  149.